前言

官方迁移wiki，必看 http://wiki.adempiere.net/Migrate java jvm/Oracle升级请移步： http://www.oracle.com postgresql升级请移步： http://www.postgresql.org 官方文件服务器： https://sourceforge.net/projects/idempiere/files 官方补丁迁移脚本：（exe运行环境的同学这里下载） https://bitbucket.org/idempiere/idempiere/src/9110e4326d3394fbee10949724d081473ce802ba/migration/?at=default

概述

请查看发布文件，并严格按照“评估-test-integration test-user acceptance test-上线”策略进行迁移。新版本肯定是测试后发行且向前兼容，除了关心升级对核心代码的影响，用户还需密切关注客户代码功能。 通常，用户需要关心： 1、了解升级内容（BUG和提升，已知问题，升级需求等） 2、基础设施和后台软件（是否变动） 3、数据一致性（数据结构和内容是否确保正确） 4、自定义模块是否可用（功能、内容是否与升级兼容且继续可用） 5、上线时间（新旧切换是否影响生产） 6、上线失败应对（设施是否备份、数据是否可恢复、应对方案是否可行） 7、升级BUG处理（升级日志是否保存，bug是否可查询）

升级工具

1. 主程序：下载官方的最新的day-server 2. 数据库：当前postgresql版本下，新建或者找到你存放升级脚本的目录，使用脚本导入sql 2.1 检查ID数据库版本：登陆页查看 2.2 官方迁移脚本：源码目录\migration，每个版本集中存放，每个版本+z表示版本升级准备。 升级原理：把各个sql灌进去，无commit为测试，测试无报错就可以加commit部署了。 脚本命名：如201407172028_IDEMPIERE-2073.sql，前面是时间戳，后面是ID的issue号。 脚本工具1：源码目录\migration\migrate_postgresql.sh（仅linux），格式化所有sql名字方便psql处理。 脚本工具2：script_to_sync_db，http://bitbucket.org/CarlosRuiz_globalqss/idempiere-stuff/raw/tip/script_to_sync_db （仅linux），自动导入所有sql文件。 总体来说，win平台下，升级还是很不方便的。 我的办法是手工（好处是知道脚本有什么变动）： psql -d yourdatabase -U adempiere 输入密码： 输入 \i 脚本.sql （按文件名升序排列一个一个来） insert 0 1 表示插入1条，update 1表示更新1条，0表示未更新。 可以自己做一个bat脚本，合并所有的sql为一个sql文件 1、dir /on /b > GenScrpt.CSV 2、csv文件插入第一列，填充“Type”，第二列为你的sql文件名 3、csv文件插入第三列，填充“>> MIGSCRPT.SQL” 4、修改第三列的第一行，填充“> MIGSCRPT.SQL”，其他不变 5、去掉csv逗号，保存csv为bat 6、运行bat，你会得到一个单独的MIGSCRPT.SQL文件 参考：http://wiki.adempiere.net/Migration#How_to_compile_migration_scripts_to_a_single_script.3F_.28Windows.29 3. 签名数据库 3.0 注意服务器版本必须与数据库版本同步，否则造成数据错误。 3.1 如果不运行版本签名，服务器控制台会报“DB.isBuildOK: Build Version Error” 3.2 运行sign-database-build.bat，窗口一闪就过，成功 3.3 如果失败，查看setup\configuration\*.log文件 4. 必须！！！升级后处理：RUN_PostMigration.bat或者源码\migration\processes_post_migration\postgresql 4.1 增加丢失的翻译：否则会报”Error: No PK nor FK -字段“ 错误。 4.2 同步翻译：升级的字段会自动成已翻译的语言。 4.3 更新序号：流水号可能重复，要检查更新一下。 4.4 更新角色访问权限：表的改动将更新到角色。 5. 大表最好运行ANALYZE得到最新统计数据。 6. 拷贝你的jetty配置：%iDempiereHome%update.bat 7. 拷贝你的皮肤：重新安装皮肤

不敢commit SQL

我用的是pgAdmin 3， sql工具不要选择“Auto commit”，运行不报错，再保存sql结果。

Shell

查找migration文件夹下所有的脚本文件
dir *.sql /s /on /b > allsql.txt

删除所有oracle的脚本记录
[^\r\n]*\\oracle\\[^\r\n]*

从数据库查看脚本迁移日志，记录数据
select filename, name,created from ad_migrationscript order by created

excel 比较2个清单的不同，我用3.1数据库一直升来的，发现官方的数据库迁移从i2.0文件夹开始有记录。

把没有导入的sql文件找出来，用上面的type方法生成一个sql文件，一次性倒入

比较前后2次ad_migrationscript的查询记录，如果不成功，导入会失败。

或者查看sql的导入error信息。

总结

1. 查看升级补丁的说明，大致了解升级会产生什么后果。 2. 需要去bitbucket网站下载一些迁移脚本。 3. 需要sql操作。 不方便，不友好，不爽。 1. UI迁移工具 2. 比较已有脚本和系统的差异，并给出链接介绍 3. 可以选择想要的脚本操作 4. 脚本测试和提交模式 5. 数据库备份、恢复操作 6. 升级报告

用户维护

1. AD对象的entity类型=用户维护（User Maintained），表示升级将不会做任何修改。 2. Change Audit功能的“Customizations”选项保证该字段的变动会被保留，升级迁移（测试）会使用该选项，保证已有数据的数据正确性。如果保留原有数据变动（升级可能需要改变某些以前的字段值），确保新旧系统不会产生矛盾bug。 参考：http://wiki.adempiere.net/Migrate_-_Marking_Customizations#Mark_Customizations_in_the_Change_Log 3. 如果用户代码命名规范，类型正确，升级一般会影响用户自定义数据，但用户端代码与核心代码关系往往千丝万缕，建议在新版本下按照用户模块发行方法重新发布用户插件和脚本。

备份

三个臭备份，顶个诸葛亮。

测试

三个臭测试，顶个诸葛亮加班。

常见问题

1. 我如何知道现有系统的版本? 2. 升级后，登陆报错？ 3. 升级后，进入工作台，报错? 4. 开发代码如何停在现有版本继续工作，而可以查看新版本源代码？

升级实例V4.1

v3.1 -> v4.1 除了手工导入脚本以外，严格按照上述步骤即可。 已知问题： 1. 已布局的tab因为脚本添加字段，导致布局变化，需要重排。 2. 部分字段出现未翻译，不知道是id变化还是新字段，待查。 总结： 1. win7 64 java1.7 postgresql9.5 2. java升级导致本次升级（特别是源码开发环境）增加难度，我保留了2个版本的java，待切换。 3. 除了sql导入花了点时间（基本没有报错），一切顺利。 4. 升级说明，先去源码网站看备注，然后找到issue号，查询开发网站https://idempiere.atlassian.net/browse/IDEMPIERE-xxxx

升级实例V5.1

v4.1 -> v5.1 http://wiki.idempiere.org/en/Note_Update_To_5.1 （1个星期后，官方的Note才出来） 1. 从源码文件找的升级脚本，总共导入了40+脚本，做成二个sql文件，二次导入 2. 然后下载的最新bin程序包，好像没有升级脚本目录。看样子还是要手工导，win不如linux 3. 重新新建51文件夹，重新使用新端口配置，通常与版本一致，比如5050，5443 4. 更改system的build版本号为登陆页的版本号，数据库版本不一致解决OK 5. 增加丢失的翻译200+条，流水号检查20+，角色更新选system有几个记录，最后同步翻译 6. 日志查找======>，发现9个记录，主要新增ckez报错，在group上看到过，新问题，需要反馈下 7. 窗口内的树控件默认全展开了。 8. 最后调整日志级别从warning到info 其他手工作业，不处理，等过几天再下载新icon主题安装程序： 3.1 拷贝utils下面的自定义批处理脚本 3.2 拷贝皮肤 3.3 解决win下console乱码问题 3.4 解决zk的富文本编辑器菜单栏串行问题，简体中文翻译问题解决。 总结： 1. 还好，直接用老数据库，都没有停数据库。 2. 建议新版本一个月以后再升级，问题还是不干净。